home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 11 / 2 / DISK1127.ZIP / WCD50ZIP.EXE / WCD50.DOC < prev    next >
Text File  |  1989-11-13  |  18KB  |  355 lines
  1.  
  2.  
  3.  
  4.  
  5.          ************************************************************
  6.          *                                                          *
  7.          *                    W O R L D   C I T Y                   *
  8.          *             D I S T A N C E   C O M P U T E R            *
  9.          *                                                          *
  10.          *                      WCD Version 5.0                     *
  11.          *                                                          *
  12.          *                      (C)opyright 1989                    *
  13.          *                    All Rights Reserved                   *
  14.          *                                                          *
  15.          *==========================================================*
  16.          *                                                          *
  17.          *                    GeoGraphics Software                  *
  18.          *                   126 Mountain View Road                 *
  19.          *                    Glastonbury, CT 06033                 *
  20.          *                                                          *
  21.          *----------------------------------------------------------*
  22.          *                                                          *
  23.          *       WCD is user-supported software provided to         *
  24.          *   you at no charge on a trial basis.  If you use this    *
  25.          *   software and find it of value please register your     *
  26.          *     copy for $15.00 and support the shareware concept.   *
  27.          *    Registered users will be provided with information    *
  28.          *    about program updates. Please make checks payable     *
  29.          *          to G. K. Marek at the above address.            *
  30.          *                                                          *
  31.          *      You are encouraged to share this software with      *
  32.          *      others provided that it is distributed complete     *
  33.          *      with documentation and in unmodified form, and      *
  34.          *     that no fee or other consideration is charged or     *
  35.          *     accepted.  All commercial, business and government   *
  36.          *           users must register each copy in use.          *
  37.          *                                                          *
  38.          *      We hope you enjoy using WCD.  Your comments and     *
  39.          *  suggestions to improve this product are always welcome. *
  40.          *                                                          *
  41.          *                                                          *
  42.          *                     November 1989                        *
  43.          ************************************************************
  44.  
  45.  
  46.  
  47.  
  48.  
  49. PROGRAM DESCRIPTION
  50.  
  51. WCD, The World City Distance Computer, is designed to provide distance
  52. and travel time information between over 700 different world cities,
  53. including most major US cities.  It allows input of user specified
  54. locations.  Flight times account for estimated enroute winds.  The
  55. program is windowed and menu driven, and contains location search
  56. capabilities.
  57.  
  58.  
  59. HARDWARE REQUIREMENTS
  60.  
  61. This program is designed for IBM Personal Computers and close
  62. compatibles.  It will execute on the IBM-PC, PC-XT, PC-jr, and on
  63. compatible 286 and 386 machines.  DOS Version 2.1 or later is required.
  64. Since the program relies extensively on color, a color monitor is
  65. recommended.  The program will run, however, unmodified, on the Compaq
  66. or Toshiba.  WCD requires about 75K of memory and does not require BASIC
  67. to operate.
  68.  
  69.  
  70. PROGRAM INFORMATION
  71.  
  72. The program is started by issuing WCD at the DOS prompt.  You will see
  73. the program loading city information from its built-in database of 200+
  74. plus US cities.  It will also load in city data from a separate datafile
  75. that the user can alter.  More about this in the DATAFILE section.
  76.  
  77. Menu instructions appear on the left and a window of city information
  78. appears on the right.  Locations are identified by a three character
  79. code which represents that city's airport code.  Most large cities use
  80. three letter codes such as ORD for Chicago's O'Hare Airport, but smaller
  81. cities may use a combination of letters and numbers.  Some cities have
  82. several airports in the database.  If the desired city code is known it
  83. can simply be entered at the keyboard.  If the code is not known, the
  84. window on the right can be used to relate the codes to the respective
  85. cities.  Use the scroll keys to search this window for the three
  86. character code of the city desired, including the Up/Down Arrows,
  87. PageUp, PageDown, Home and End keys.  Pressing [Enter] will select the
  88. city highlighted in the window.
  89.  
  90. The function keys [F1] - [F9] provide functions to assist in specifying
  91. your desired city pairs including a database search function.  See the
  92. FUNCTION KEY section for detailed description.
  93.  
  94.  
  95. PROGRAM FILES
  96.  
  97. The World City Distance Computer system comes in four primary files:
  98.  
  99.   NAME            SIZE     DESCRIPTION
  100.   WCD.EXE         74496    Executable program module
  101.   WCD.DAT         27023    Extra cities information
  102.   WCD50.DOC                Documentation file (ASCII); (this file)
  103.   WCDREAD.ME               Short program description with latest changes
  104.  
  105. Check the file sizes with the above figures as a measure of protection
  106. against viruses.
  107.  
  108. There are additional datafiles included with the filetype "DAT".  For
  109. example, WCDUSA.DAT contains extra cities in the USA, Canada, and
  110. Mexico.  All of these files are packaged in a self-extracting archive file
  111. called WCD50ZIP.EXE which creates each file when the archive file is
  112. run.  The PKZIP Program comes from PKWARE, Inc., 7545 N. Port Washington
  113. Road, Glendale, WI 53217-3442.
  114.  
  115.  
  116. The program file, WCD.EXE, must reside on the current directory or path.
  117. A datafile (WCD.DAT is the default) must reside on the current directory
  118. or path for the data to be accessible.
  119.  
  120. None of these files is copy-protected and it is suggested that the
  121. archive file be saved in a separate place with your other archive and
  122. backup files.  Just run it again for a fresh copy of all the files.  To
  123. share this software with others, please copy and transmit the ZIP file
  124. alone so that the original program and files will remain intact inside
  125. it.
  126.  
  127.  
  128. STARTING THE PROGRAM
  129.  
  130. The program runs by issuing the command WCD at the DOS prompt.  The user
  131. is then asked for a datafile name, with the default specified as
  132. WCD.DAT.  If the [Enter] key is pressed the default file will be loaded
  133. if it exists on the current directory or path.  If another file name is
  134. specified, it will be loaded.  As explained later, this procedure allows
  135. the user to construct his own set of cities data.  Loading the datafiles
  136. from a hard disk speeds up the process considerably.
  137.  
  138.  
  139. FUNCTION KEYS
  140.  
  141. [F1] - SEARCH....for a particular string of characters in city list
  142. [F2] - ERASE.....start selection of this particular city over
  143. [F3] - NEW.......start total selection process over
  144. [F4] - COORDS....enter a latitude and longitude instead of city name
  145. [F5] - LASTCITY..use last city chosen for this city input
  146. [F6] - AIRCRAFT..choose a particular aircraft type or cruise speed
  147. [F9] - QUIT......end program and return to DOS (or use [Esc])
  148.  
  149.  
  150. DISTANCE INFORMATION SCREEN
  151.  
  152. Once all of the inputs are provided, a pop-up screen appears in the
  153. lower left which contains output information.  It includes distances
  154. (both great circle distance and equivalent still air distance, which are
  155. explained below) in three sets of units, the estimated flying time, the
  156. direct bearing angle from the first city to the second, and an enroute
  157. high altitude winds estimate.  Negative winds are headwinds and positive
  158. values represent tailwinds.
  159.  
  160. The computation of FLIGHT TIME is quite complex.  First, the time for
  161. the great circle flight is determined from empirical information on
  162. flight speed as a function of route distance for jet aircraft.  This
  163. time is then corrected for winds based upon a model of world high
  164. altitude winds using the specific route flown.  This flight time is
  165. accurate to about 10 minutes or 10% of the elapsed flight time,
  166. whichever is greater.  The flight time is from "wheels up" to "wheels
  167. down" and therefore does not include any taxi or gate time.  It does not
  168. account for traffic delays, airport area maneuvering, airways that do
  169. not closely follow the great circle route, or enroute stops.
  170.  
  171. The BEARING is the direction of departure from the origin city along the
  172. great circle path toward the destination city.  It is measured from the
  173. origin city by basic compass direction.  Thus, the bearing from LA to
  174. New York is 65 degrees clockwise from due north (or about
  175. east-northeast) and the bearing from LA to San Francisco is 320 degress
  176. (or about north-northwest).  On longer distances, the initial bearing
  177. might seem deceiving because of the great circle routing.  For example,
  178. the initial bearing from Tokyo to Los Angeles is 55 degrees, or east
  179. north-east, even though LA is actually south of Tokyo (33 degrees north
  180. latitude for LA, versus 35 degrees for Tokyo).  So the shortest distance
  181. from Tokyo to LA actually starts off headed north even though LA is more
  182. southerly!  Try it with a globe and string to check for yourself.
  183.  
  184.  
  185. A WORD ABOUT DISTANCE AND TIME
  186.  
  187. The distances computed are based upon the "GREAT CIRCLE DISTANCE (GCD)"
  188. between the two cities, which can be thought of as the route described
  189. by a string pulled taut between the two cities on a globe.  This
  190. represents the shortest physical distance between the two cities.  City
  191. locations in WCD are specified as the city's airport location.  City
  192. center lats/longs are available from some world almanacs and could be
  193. input by the user if desired using the supplemental database.  Remember
  194. that WCD computes the SHORTEST distance between cities (i.e., "as the
  195. crow flies"), so it will only be an estimate of driving distances since
  196. cars cannot follow the shortest route.
  197.  
  198. These great circle distances between cities are geometrically correct
  199. for a spherical globe.  For airplane flight purposes, however,
  200. prevailing head or tail winds make the apparent distance different and
  201. should be taken into account.  High altitude winds can be greater than
  202. 60 knots and are significant for the flight time calculation.  For
  203. example, the great circle distance between Los Angeles and New York is
  204. 2467 statute miles.  But an airplane traveling between these cities
  205. faces a prevailing headwind of 25 knots when headed westbound (i.e. from
  206. New York to LA) and a prevailing tailwind of 22 knots in the other
  207. direction.  Thus the eastbound flight is shorter in time than the
  208. westbound because it is assisted by the wind rather than hindered.  The
  209. "EQUIVALENT STILL AIR DISTANCE (ESAD)" accounts for this wind effect.
  210. Flying against the wind, the ESAD is greater than the GCD since the
  211. headwind causes the plane to fly longer to reach its destination.  Thus
  212. the ESAD from NYC to LA is 2611 statute miles and takes 5 hours and 33
  213. minutes (against the wind) while the ESAD from LA to NYC is 2351 statue
  214. miles and takes only 5 hours and 2 minutes (with the wind's help).  This
  215. ESAD is used to compute the flight time that accounts for the effects of
  216. enroute winds.  So, although the great circle distance between two
  217. cities is the same in both directions, because of prevailing winds, the
  218. equivalent still air distances and the flight times are not.
  219.  
  220. IF THIS CONFUSES YOU A LITTLE, just remember that the ACTUAL DISTANCE
  221. between a city pair is the great circle distance (GCD), and that the
  222. FLIGHT TIME is computed to include the effects of the wind in the
  223. correct direction.
  224.  
  225.  
  226. AIRCRAFT SELECTOR
  227.  
  228. Function Key 6 from the Main Menu will allow selection of cruise speeds
  229. for various aircraft types.  Commercial jetliners are the default value.
  230. The program also allows the input of a cruise speed value.
  231.  
  232.      Commercial Jetliner       434 Knots
  233.      Sabreliner (BizJet)       440 Knots
  234.      Kingair (Turboprop)       230 Knots
  235.  
  236. The program automatically accounts for the fact that aircraft cannot fly
  237. at cruise speed throughout the flight by applying factors from actual
  238. commercial aircraft flying experience.
  239.  
  240.  
  241. LOCATION FEATURE
  242.  
  243. This feature is designed for onboard laptop users in window seats!  The
  244. rest of you will have to use your imagination.  Once the origin and
  245. destination cities have been selected, the LOCATION option allows you to
  246. determine your enroute position along the great circle route.  The
  247. elapsed time since takeoff is entered in hours/minutes (HH.MM), for
  248. example, 8.57 is 8 Hours 57 Minutes, and 0.45 is 45 Minutes enroute
  249. time.  Then the user has the option of entering a more accurate total
  250. flight time based upon information from the cockpit.  If no more
  251. accurate flight time is available, just press [Enter] and the total
  252. flight time computed by the program in the box on the lower left will be
  253. used.  The program then determines your location along the great circle
  254. path and provides a listing of nearby cities with distances from the
  255. aircraft and directions.  Since airliners often do not follow the exact
  256. great circle route, but use airways, this location will be an
  257. approximation and the indicated cities will probably not be in exactly
  258. these directions or distances.  But they should be in the vicinity, so
  259. keep your eyes open for them.  On slower computers, this extensive
  260. search routine can take a minute or more so please be patient.  On
  261. faster machines, cities can be determined in 2 to 10 seconds.  This is
  262. the closest a passenger will get (for a while) to an inertial navigation
  263. system at their seat!
  264.  
  265.  
  266. DATAFILES
  267.  
  268. The program allows the user to include additional city pairs from
  269. supplementary datafiles.  The default datafile is called WCD.DAT.  This
  270. file is provided with the programs and contains many additional smaller
  271. or less popular cities that the user may wish to select to be included
  272. in the program when it is run.  If you are satisfied with the cities in
  273. the program itself and do not require additional cities, you may remove
  274. this file (WCD.DAT) from the current directory to speed the loading of
  275. the program.
  276.  
  277. Memory space precludes fitting all of the additional cities within the
  278. program itself.  As supplied, only a few additional cities are selected
  279. for loading although hundreds of additional cities will fit.  You can
  280. edit this file with a typical line editor (such as KEDIT or EDLIN) to
  281. select other cities or remove those selected by changing Field A as
  282. instructed below.  The user can also add additional lines to this file
  283. to include other cities (or locations) of his choosing.  The format of
  284. the file, sampled from the middle of the datafile, is as follows:
  285.  
  286. COLUMN   1         2         3         4         5         6         7
  287. 12345678901234567890123456789012345678901234567890123456789012345678901
  288.  
  289. FIELD....................................................
  290. A      B                  C           D      E       F
  291. ...
  292. 0, BARRANQUILLA,    COLUMBIA,        BAQ,  10.54,   74.47
  293. 1, BASEL,           SWITZERLAND,     BSL,  47.35,   -7.32
  294. 0, BASRA,           IRAQ,            BSR,  30.33,  -47.47
  295. 0, BATTLE CREEK,    MICHIGAN,        BTL,  42.19,   85.15
  296. 0, BATTLE MOUNTAIN, NEVADA USA,      BAM,  40.36,  116.52
  297. ...
  298. 0, ZZ***,           ******,          ***,   0.00,    0.00  (Last Line)
  299.  
  300. The data columns are not critical, although retaining the existing
  301. columns will make spotting errors easier.  The commas between fields ARE
  302. critical since they actually delimit (or separate) the data fields.
  303. Field descriptions:
  304.  
  305. Field A- 1-INCLUDE in program; 0-Do NOT include.
  306. Field B- Description of City Name (16 characters maximum)
  307. Field C- Additional description such as State & Country (16 char max)
  308. Field D- A Three-Digit City Code designator (Numbers can be used)
  309. Field E- The City Latitude  (North of Equator is positive)
  310. Field F- The City Longitude (West of Greenwich is positive)
  311.  
  312. In the sample data above, Basel would be added to the program
  313. while the other cities would not.  The latitudes and longitudes are
  314. given in degrees and minutes in this format: DDD.MM.  Be careful with
  315. the proper sign to differentiate north from south and east from west.
  316.  
  317. If the city name and code of any two cities exactly match, the program
  318. will use the last entry.  This prevents duplicate entries and also
  319. allows the user to supply his own data for cities already in the program
  320. itself.
  321.  
  322. Entire lines of data can be added to or deleted from this file.  Thus
  323. you can add new cities such as your hometown.  Lines deleted from this
  324. file will make the loading process a little faster, so if you are sure
  325. you don't care about a given city in this file you can eliminate it.
  326. The last line of the file containing dummy fields MUST be preserved
  327. since it indicates the end of the data to the program.
  328.  
  329. You can always reconstruct the original datafiles from the ZIP file by
  330. re-extracting, but be careful to backup any new datafiles you have
  331. created so they are not overwritten during extraction.
  332.  
  333. An additional city datafile called WCDUSA.DAT is provided which is
  334. simply a subset of the WCD.DAT file.  WCDUSA.DAT contains all cities
  335. from WCD.DAT that are in the United States, Canada or Mexico.  For
  336. convenience, all the cities in this file are turned on (with a "1" in
  337. Field A.) This datafile or any other datafile the user specifies will be
  338. loaded into the program if specified when the program is started.  Just
  339. remember that it must conform to the formats indicated above.
  340.  
  341.  
  342. A FINAL WORD
  343.  
  344. We hope that you enjoy WCD and will register if you find it valuable and
  345. are using it.  That way you will be informed of future enhancements and
  346. will be supporting the shareware concept which allows you to see and try
  347. programs before you pay for them.  Where else can you write to the
  348. programmer and offer your ideas for future versions?  We've incorporated
  349. many user conceived ideas.
  350.  
  351. Your comments and suggestions for improvements are always welcomed.
  352.  
  353.  
  354.                        - O - O - O - O - O -
  355.